home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir39 / dosfdate.zip / FILEDATE.DOC next >
Text File  |  1993-12-27  |  3KB  |  72 lines
  1. DOCUMENTATION FOR FILEDATE.EXE
  2.  
  3.  
  4.  
  5. Program:    FILEDATE.EXE
  6. Version:    1.0
  7.  
  8.    Date:    12/27/93
  9.      By:    Ty Drago
  10.         Peridot Consulting, Inc.
  11.            32 Pennsylvania Avenue
  12.            Stratford, NJ 08084
  13.  
  14.  
  15.  
  16. FILEDATE.EXE came about when a friend of mine called and asked if there
  17. was a DOS utility that allowed someone to easily change the current date
  18. and time on a file.  I told him no, and then proceeded to write a little
  19. something to do just that.
  20.  
  21. FILEDATE.EXE may be called from the DOS Command Line, from a batch prorgram,
  22. or from a DOS-based program.  It will work with Windows-based programs, but
  23. requires Windows to kick off a DOS session to do so and that's all a lot of 
  24. work and bother.  Those interested in performing this task from a Windows
  25. -based development package may check their local BBS for WINFDATE.EXE, which 
  26. is the Windows-based version of this utility.  WINFDATE functions the same 
  27. way as FILEDATE, but may be called from a Windows program or from the Program 
  28. Manager's RUN facility.
  29.  
  30. Anyhow, FILEDATE takes three (3) parameters, and these must be provided in
  31. exactly the manner it expects.
  32.  
  33.  
  34.     
  35.         FILEDATE <C:\PATH\NAME.EXT> <MMDDYYYY> <HHMM>
  36.  
  37.  
  38.     C:\PATH\NAME.EXT = Name of file to be dated.
  39.                Full paths are supported but wildcards are 
  40.                not permitted. FILEDATE works on only 1 file
  41.                at a time.  What do you want for free?
  42.  
  43.             MMDDYYYY = New date for file.  Full year must be provided.
  44.                There should be no '-' or '/' between month,
  45.                date and year.
  46.                EX: 04/11/93 should be entered as 04111993
  47.  
  48.             HHMM = New time for file.  Hours and minutes in military
  49.                time.  Seconds are reset to zero.
  50.                EX: Entering 1422 sets file time to 02:22:00 pm.
  51.  
  52.  
  53. If any or all of these parameters are excluded, then FILEDATE will prompt
  54. the caller to enter them.  Once all parameters are entered, FILEDATE will 
  55. display the old date/time and the new date/time.  To avoid any output at all
  56. (such as for calls from programs), include ALL paramters at call-time.
  57.  
  58. In all cases: FILEDATE returns DOS errorlevels:
  59.  
  60.      zero (0) if the file date/time was successfully changed.
  61.      one (1) if the file given could NOT be found.
  62.      two (2) if the file's current date/time could NOT be read.
  63.      three (3) if the file date/time could NOT be changed.
  64.  
  65.  
  66. NOTE: THIS PROGRAM IS OFFERED AS FREEWARE, AND MAY BE DISTRIBUTED AND
  67.       USED WITHOUT CHARGE.  THE SOURCE CODE IS AVAILABLE FOR A $10 FEE
  68.       BY WRITING TO THE ADDRESS ABOVE.  THIS PROGRAM IS AS-IS AND 
  69.       OFFERED WITHOUT ANY EXPLICIT OR IMPLICIT WARRANTY.
  70.  
  71.     
  72.